SmartAgent Version 10.2.1
发布日期：2026 年 7 月 16 日
版本概述
SmartAgent 10.2.1 为 10.2.x 功能增强版 本。由于 10.2.0 版本未单独发布，其变更内容已合入 10.2.1 一并发布。本版本集成 JavaAgent 9.15.0、logsAgent 3.0.2 等子探针升级，并优化 RocketMQ 启动类监控及探针卸载行为。
10.2.0 版本变更（合入 10.2.1 发布）
-
✨ JavaAgent 9.15.0：新增 spring webclient/restclient、log4j2 string layouts、Hikari poolName、spring ai、腾讯 TDMQ-Pulsar 等适配；优化 URL 路径提取、sql connect 数据库名识别及 spring webflux js 注入兼容性
-
🔧 SmartAgent 自身：默认忽略 RocketMQ 启动类监控；卸载探针时保留 cache 目录，避免非覆盖升级导致挂载到容器内的 cache 失效
-
🔧 logsAgent 3.0.2（Windows）：修复 Windows CPU 占用量计算错误导致误触熔断（影响范围：SmartAgent 10.0.0～10.1.2）
10.2.1 版本变更
- 🔧 NginxAgent 3.10.2：修复探针日志中大量
url.len <= offset警告（影响范围：SmartAgent 9.12.6～10.1.2）
升级建议
- 使用 spring webclient/restclient、spring ai 或 腾讯 TDMQ-Pulsar 的 Java 应用环境，建议升级以获得完整监控适配；
- 使用 RocketMQ 且需排除启动类监控的场景，可升级后利用默认忽略配置；
- 容器内挂载 cache 目录且需 非覆盖升级 的环境，建议升级以避免 cache 失效；
- Windows 环境使用 logsAgent 3.0.0～3.0.1 且误触熔断的用户，建议尽快升级；
- 使用 NginxAgent 且探针日志存在大量
[warn] url.len <= offset警告的环境，建议尽快升级。
Linux x86_64 系统
支持平台版本
- One 平台：V2.2.2 及以上版本
集成探针版本
- JavaAgent: 9.15.0
- DotnetAgent: 6.16.1
- PHPAgent: 8.7.0
- PythonAgent: 8.7.4
- NodejsAgent: 8.0.1
- NginxAgent: 3.10.2
- ApacheAgent: 3.5.0
- SDKAgent: 5.16.1
- GoAgent: 5.0.3
- logsAgent: 3.0.2
10.2.0 版本变更（合入 10.2.1 发布）
1. JavaAgent 升级至 9.15.0
新增功能
- 新增适配 spring webclient 5.1 & 6.0；
- 新增适配 spring restclient 4.1.2；
- 新增适配 log4j2 string layouts；
- 新增适配采集 Hikari poolName；
- 新增适配 spring ai 1.0.0/1.0.9/1.1.2/1.1.8；
- 新增适配腾讯 TDMQ-Pulsar 2.7.1/2.7.2/2.9.2。
功能优化
- 优化 URL 路径提取（
/http:/*）； - sql connect 数据库名识别优化；
- 优化 spring webflux js 注入的兼容性。
2. SmartAgent 自身优化
功能优化
- 默认忽略 RocketMQ 启动类监控：
org.apache.rocketmq.namesrv.NamesrvStartuporg.apache.rocketmq.broker.BrokerStartuporg.apache.rocketmq.proxy.ProxyStartuporg.apache.rocketmq.controller.ControllerStartuporg.apache.rocketmq.tools.command.MQAdminStartup
- 卸载探针时保留 cache 目录，避免非覆盖升级导致挂载到容器内的 cache 失效。
10.2.1 版本变更
1. NginxAgent 升级至 3.10.2
修复 Bug
- 修复探针日志存在大量
[warn] 19#19: url.len <= offset. ...警告的问题（影响范围：NginxAgent 3.8.5～3.10.1，对应 SmartAgent 9.12.6～10.1.2）。 - 具体场景：proxy_pass 场景 url 和 location 长度相同时，即
url.len == offset，不应报 warn。
Linux ARM64 系统
支持平台版本
- One 平台：V2.2.2 及以上版本
集成探针版本
- JavaAgent: 9.15.0
- DotnetAgent: 6.16.1
- PHPAgent: 8.7.0
- PythonAgent: 8.7.4
- NginxAgent: 3.10.2
- SDKAgent: 5.16.1
- GoAgent: 5.0.3
- logsAgent: 3.0.2
10.2.0 版本变更（合入 10.2.1 发布）
1. JavaAgent 升级至 9.15.0
新增功能
- 新增适配 spring webclient 5.1 & 6.0；
- 新增适配 spring restclient 4.1.2；
- 新增适配 log4j2 string layouts；
- 新增适配采集 Hikari poolName；
- 新增适配 spring ai 1.0.0/1.0.9/1.1.2/1.1.8；
- 新增适配腾讯 TDMQ-Pulsar 2.7.1/2.7.2/2.9.2。
功能优化
- 优化 URL 路径提取（
/http:/*）； - sql connect 数据库名识别优化；
- 优化 spring webflux js 注入的兼容性。
2. SmartAgent 自身优化
功能优化
- 默认忽略 RocketMQ 启动类监控（同 Linux x86_64）；
- 卸载探针时保留 cache 目录，避免非覆盖升级导致挂载到容器内的 cache 失效。
10.2.1 版本变更
1. NginxAgent 升级至 3.10.2
修复 Bug
- 修复探针日志存在大量
[warn] 19#19: url.len <= offset. ...警告的问题（影响范围：NginxAgent 3.8.5～3.10.1，对 应 SmartAgent 9.12.6～10.1.2）。 - 具体场景：proxy_pass 场景 url 和 location 长度相同时，即
url.len == offset，不应报 warn。
平台说明
- ARM64 平台暂不支持 NodejsAgent、ApacheAgent
Windows x86_64 平台
支持平台版本
- One 平台：V2.2.2 及以上版本
集成探针版本
- JavaAgent: 9.15.0
- DotnetAgent: 6.16.1
- logsAgent: 3.0.2
10.2.0 版本变更（合入 10.2.1 发布）
1. JavaAgent 升级至 9.15.0
新增功能
- 新增适配 spring webclient 5.1 & 6.0；
- 新增适配 spring restclient 4.1.2；
- 新增适配 log4j2 string layouts；
- 新增适配采集 Hikari poolName；
- 新增适配 spring ai 1.0.0/1.0.9/1.1.2/1.1.8；
- 新增适配腾讯 TDMQ-Pulsar 2.7.1/2.7.2/2.9.2。
功能优化
- 优化 URL 路径提取（
/http:/*）； - sql connect 数据库名识别优化；
- 优化 spring webflux js 注入的兼容性。
2. logsAgent 升级至 3.0.2
修复 Bug
- 修复 Windows CPU 占用量计算错误导致误触熔断（影响范围：logsAgent 3.0.0～3.0.1，对应 SmartAgent 10.0.0～10.1.2）。
3. SmartAgent 自身优化
功能优化
- 默认忽略 RocketMQ 启动类监控（同 Linux x86_64）。
平台说明
本版本 Windows 平台无 10.2.1 专属功能变更。
兼容性说明
平台兼容性
| 操作系统 | 支持架构 | 最低 One 版本 |
|---|---|---|
| Linux | x86_64 | V2.2.2 |
| Linux | ARM64 | V2.2.2 |
| Windows | x86_64 | V2.2.2 |